manual: document bare-user-only repo mode

Closes: #903
Approved by: cgwalters

diff --git a/docs/manual/repo.md b/docs/manual/repo.md
index 6e307ba3c0ee6097a85452eccdd885e384349584..6b547be694547f48fb686389164fa91bcc42db1e 100644 (file)
--- a/docs/manual/repo.md
+++ b/docs/manual/repo.md
@@ -81,6 +81,13 @@ The `bare-user` mode is useful for build systems that run as non-root
 but want to generate root-owned content, as well as non-root container
 systems.
 
+There is a variant to the `bare-user` mode called `bare-user-only`. Unlike
+`bare-user`, neither ownership nor extended attributes are stored. These repos
+are meant to to be checked out in user mode (with the `-U` flag), where this
+information is not applied anyway. The main advantage of `bare-user-only` is
+that repos can be stored on filesystems which do not support extended
+attributes, such as tmpfs.
+
 In contrast, the `archive-z2` mode is designed for serving via plain
 HTTP.  Like tar files, it can be read/written by non-root users.